home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / dstool / user_upd < prev   
Text File  |  1994-10-23  |  3KB  |  72 lines

  1.  
  2. For version 1.1, there have been some small changes in user dstool 
  3. configurations. 
  4.  
  5. Users of version 1.0 who install their own models have a local directory,
  6. <personal-dstool> (often $HOME/dstool) for their customized configurations.
  7. The directory <personal-dstool> has two subdirectories, "models", and
  8. "userlib". 
  9.  
  10. Under version 1.0, when installing a model in the file <model_def>, users 
  11. added lines to the files 
  12.     <personal-dstool>/models/Makefile
  13.     <personal-dstool>/models/modellib_ds_def.h
  14. as well as creating the file <model_def> by editing     
  15.     <personal-dstool>/models/GENERIC.c.
  16.  
  17. Under version 1.1, several Makefiles have changed, the file
  18. "modellib_ds_def.h" has been replaced by "modellib_ds_def.c" and
  19. the header files included in each model file have changed slightly.
  20.  
  21. We're sorry users have to make changes in upgrading. The changes 
  22. advance dstool portability, and will be of further aid in 
  23. future releases.
  24.  
  25. To upgrade, we suggest the following:
  26.  
  27.     a) Create a new user dstool subdirectory <new_personal_directory>,
  28.     e.g. $HOME/dstool_1.1. Let <old_personal_directory> be
  29.     your previous user dstool subdirectory, e.g. $HOME/dstool.
  30.  
  31.     b) Be sure your DSTOOL environment variable is set to the
  32.     new central dstool_1.1 source directory, e.g. /usr/local/dstool_1.1.
  33.     If you use the now optional DSTOOL_COLOR_DIR environment variable,
  34.     set it to $DSTOOL/colormaps.
  35.  
  36.     c) Type:
  37.         $DSTOOL/bin/install_dsuser
  38.     
  39.     d) Answer the question about "user-dstool directory" by
  40.     specifying the full pathname (no environment variables or
  41.     other csh abbreviations) of <new_personal_directory>.
  42.  
  43.     e) For each new model you installed in <old_personal_directory>/models,
  44.     copy it to <new_personal_directory>/models.
  45.  
  46.     f) cd <new_personal_directory>/models
  47.  
  48.     g) Invoke the script "update_model" (or $DSTOOL/bin/update_model)
  49.     on each of the files you copied in step e). (Typing 
  50.     "update_model *.c" is a safe shortcut.)
  51.  
  52.     h) Edit the file modellib_ds_def.c. For each model menu entry
  53.     you added in <old_personal_directory>/models/modellib_ds_def.h,
  54.     copy the line to <new_personal_directory>/models/modellib_ds_def.c.
  55.         ( e.g. for your additional models, copy lines like
  56.             { 1, "Lorenz System", lorenz_init } 
  57.           in the initialization of 
  58.             struct    DS_DataS    DS_Sel[] =
  59.         )
  60.  
  61.     i) Edit the SOURCES_B line in <new_personal_directory>/models/Makefile 
  62.     to include each model source file which you have added.
  63.  
  64. You should now be all set. Assuming the environment variables DSTOOL,
  65. OPENWINHOME, and LD_LIBRARY_PATH are properly set, changing to 
  66. <new_personal_directory> and typing "make" should compile an updated 
  67. customized "dstool_u".
  68.  
  69.  
  70.  
  71.  
  72.